home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_4 / nsclk170.ads < prev    next >
Text File  |  1995-06-11  |  8KB  |  183 lines
  1.            ADS Zone: 1
  2.      ADS Hatch Site: Paul Miller
  3.        ADS Position: ADS Zone 1 STAR
  4.            BBS Name: Lonely Mountain BBS
  5.     Phone Number(s): 804-827-0726
  6.     Network Address: 1:271/292  
  7.      Network Region: 13    
  8.           BBS Hours: 24 Hrs/Day
  9. BBS Mailer/Software: Mebbs-Net Pro BBS
  10.   BBS Storage Space: 2250 Megs + 8 CD Roms
  11.   File Requestable :  <X> Y     < > N
  12. File Request Hours : All The Time
  13. Short:    Many Options. Vanishes for Prefs change.
  14. Author:   John D. Muir <John_Muir@UManitoba.Ca>
  15. Uploader: John D. Muir <John_Muir@UManitoba.Ca>
  16. Type:     util/time
  17.  
  18.                          NISClock 1.70 (27.5.95)
  19.                         ⌐ Copyright 1995 John Muir
  20.                            Written by John Muir
  21. ___________________________________________________________________________
  22. Introduction
  23.  
  24. NISClock is a small clock program that uses a minimum amount of CPU time
  25. since it only updates the clock every minute (or every second if you
  26. wish).  It can make use of Stephan Becker's screennotify.library which
  27. patches a few intuition.library functions so that the clock will
  28. automatically close its window if the Workbench screen is removed by
  29. IPrefs for a preferences change or by any other program which calls
  30. CloseWorkbench().
  31.  
  32. ___________________________________________________________________________
  33. Requirements
  34.  
  35. - Requires V37 (2.04) of the Amiga OS, but can use V39 features.
  36. - Optionally uses screennotify.library by Stephan Becker.  See
  37.  'Installation' for more information on screennotify.library.
  38. - NISClock must be run from the Workbench.
  39.  
  40. ___________________________________________________________________________
  41. Installation
  42.  
  43. With the workbench, you can just copy NISClock to the WBStartup drawer to
  44. have the program execute as you boot-up.  If you have a 68020 or better,
  45. you can use NISClock020 instead.
  46.  
  47. screennotify.library by Stephan Becker must be installed in LIBS: or
  48. PROGDIR: (the directory where NISClock is started from).  Get
  49. screennofity.library from the distribution archive on AmiNET:
  50.  
  51. /pub/aminet/util/libs/ScreenNotify10.lha
  52.  
  53. screennotify.library is also available in the latest ToolManager
  54. distribution archive(s) which I recommend highly;
  55.  
  56. /pub/aminet/util/boot/ToolManager21?.lha
  57.  
  58. ___________________________________________________________________________
  59. Usage
  60.  
  61. NISClock will only run from the Workbench and it supports the following
  62. tooltypes;
  63.  
  64.   SECONDS - Boolean; true when the tooltype exists.
  65.        - display seconds when true.
  66.  
  67.   24HOUR - Boolean
  68.        - display the time in 24 hour mode.
  69.  
  70.   INTITLEBAR - Boolean
  71.        - display the time in the title bar colours, otherwise a box
  72.         is drawn on the edge of the window to match the depth gadget.
  73.        - NOTE: V37: Backpen = 2 (White) and FrontPen = 1 (Black).
  74.  
  75.   FULLYEAR - Boolean
  76.        - display the year part as YYYY.
  77.  
  78.   TIMEDATE - Boolean
  79.        - display the date and time at the same time.
  80.  
  81.   LEFTEDGE - Numeric; eg: LEFTEDGE=400
  82.        - the value represents the left edge of the NISClock window.
  83.        - -1 for default position.
  84.        - the window cannot be positioned with the mouse, so make good use
  85.         of the file notificaiton on NISClock.info! :)
  86.  
  87.   DATEFORMAT - Enumerated; eg: DATEFORMAT=DDMMYY
  88.        - display the date in the requested format;
  89.         DATEFORMAT = DDMMYY (default), MMDDYY or YYMMDD.
  90.  
  91.   JUSTIFICATION - Enumerated
  92.        - display the time and/or date with justification;
  93.         JUSTIFICATION = CENTER, RIGHT, LEFT, or NONE.
  94.        - NONE means RIGHT when INTITLEBAR is ON, and CENTER otherwise.
  95.  
  96. NISClock will automatically update itself if the icon tooltypes are
  97. changed.
  98.  
  99. A mouse click on the NISClock window will cause the date to be displayed
  100. unless TIMEDATE is true.  Additional Clicking will toggle between Time and
  101. Date.  The Time will automatically reappear after 4 seconds.
  102.  
  103. To STOP NISClock, simply run the program again.
  104. NISClock WILL NOT RUN without screennotify.library.
  105. NISClock WILL NOT RUN from the CLI.
  106.  
  107. ___________________________________________________________________________
  108. Comments? Talk to me!
  109.  
  110. EMail:     John D. Muir <John_Muir@UManitoba.Ca>
  111.     or     John Derek Muir <ummuir05@cc.umanitoba.ca>
  112.  
  113. Snail Mail:
  114.     John Muir
  115.     3-152 Guigues Ave.
  116.     Ottawa, ON
  117.     K1N 5H9
  118.     CANADA
  119.  
  120. ___________________________________________________________________________
  121. History
  122.  
  123. 0.99 - Released to IRC for testing.  Tested on OS2.x and OS3.x.
  124. 1.0  - Released to AmiNET. 68000 version compiled... (oops! :)
  125. 1.1  - Now displays the date with a mouse click on the Window.
  126.      - Date disappears after 5 seconds.
  127.      - Fixed a few bugs.
  128. 1.2  - Reduced Code Size.
  129.      - Date disappears after 4 seconds now.
  130.      - Date is displayed in standard DD.MM.YY, 0s removed.
  131. 1.2a - BUGFIX: 10 o'clock now shows the 1...
  132. 1.3  - Added the tooltypes; SECONDS, 24HOUR, INTITLEBAR
  133.      - INTITLEBAR requires intuition.library >= V39.
  134. 1.4  - Added the DATEFORMAT tooltype.  See "Usage" for more.
  135.      - INTITLEBAR no longer requires V39.  Pens 1 and 2 are used as
  136.       foreground and background respectively.
  137. 1.5  - JUSTIFICATION tooltype added. (NONE, LEFT, RIGHT, or CENTER) RIGHT
  138.       is the default for INTITLBAR=1, while CENTER is the default for
  139.       INTITLEBAR=0.
  140.      - FULLYEAR causes YYYY to be displayed instead of YY.
  141.      - TIMEDATE causes the time and the date to be displayed at the same
  142.       time.
  143.      - 68030 Compilation included.
  144.      - The icon is a NewIcons icon. Thanks to Gavin Hamil.
  145. 1.51 - Small Code optimizations -> 76 byte reduction.
  146. 1.60 - Oops... I forgot that the revision number is not decimal..
  147.      - You can now position the window using the LEFTEDGE tooltype.
  148.      - Reworked the USAGE section of the .readme file.
  149.      - Including an '020 compilation instead of '030 since they are the
  150.       same size.
  151. 1.61 - Size optimizations.  '020 version is now under 4k!!
  152. 1.62 - BUGFIX: Now the program does not try to reopen its window 5 seconds
  153.       after being notified of a Closed Workbench.  Although NISClock opens
  154.       on the Default public screen, it is a good idea to make it run on the
  155.       Workbench screen, because otherwise it may cause problems with other
  156.       programs such as Directory Opus.  Maybe I'll implement opening on a
  157.       PUBSCREEN of choice..
  158.      - BUGFIX: ToolTypes can now be turned off with icon notification
  159.       after the program has been running. (Notification worked, but you
  160.       couldn't turn off the options... ;)
  161.      - Size optimizations.  Lost 112 bytes (116 for '020 version).
  162. 1.70 - No longer requires screennotify.library.
  163.      - BUGFIX: Defaults for JUSTIFICATION and DATEFMT are now set properly
  164.       if the tooltypes aren't found.
  165.      - Handles other public screens properly, if you should manage to get
  166.       NISClock on a screen besides Workbench. ie; NISClock will close its
  167.       window if the Public Screen is closed.  Provided you are using
  168.       screennotify.library of course.
  169.      - Two spaces between Date and Time when TIMEDATE is set.
  170.      - WARNING: Do not use screennotify.library and ScreenTab at the same
  171.       time if you have windows that subscribe to screennotify.library
  172.       (NISClock) on OTHER public screens (besides Workbench) or intuition
  173.       will Dead-Lock.
  174.  
  175. ___________________________________________________________________________
  176. To Do - Let me know if you have a favorite or suggestions.
  177.  
  178.      - PUBSCREEN of your choice. (maybe)
  179.      - Localization; time and date are displayed in the format specified
  180.       by your locale.  (v2.0)
  181.      - The weekday written. <- localized.  (v2.0)
  182.      - The month written. <- localized.  (v2.0)
  183.